package com.cargohu.aishouyu.file.service;

import com.cargohu.aishouyu.file.dto.FileAddDTO;
import com.cargohu.aishouyu.file.dto.FileUpdateDTO;
import com.cargohu.aishouyu.file.entity.File;
import com.cargohu.aishouyu.file.req.FileRequest;
import com.cargohu.aishouyu.file.resp.FileDetailVo;
import com.cargohu.aishouyu.file.resp.FileResponse;
import com.cargohu.aishouyu.framework.page.Paging;
import com.cargohu.aishouyu.framework.service.BaseService;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletResponse;
import java.util.Map;

/**
 * 文件管理表 服务接口
 *
 * @author aaron.wang
 * @since 2024-01-07
 */
public interface FileService extends BaseService<File> {

    /**
     * 添加文件管理表
     *
     * @param fileAddDTO
     * @return
     * @throws Exception
     */
    boolean addFile(FileAddDTO fileAddDTO) throws Exception;

    /**
     * 上传文件
     *
     * @param file
     * @return
     */
    Map<String, String> uploadFile(MultipartFile file);

    /**
     * 修改文件管理表
     *
     * @param fileUpdateDTO
     * @return
     * @throws Exception
     */
    boolean updateFile(FileUpdateDTO fileUpdateDTO) throws Exception;


    /**
     * 读取文件
     *
     * @param bucket   桶名称
     * @param fileName 文件名称
     * @param response 输出流
     */
    void getFile(String bucket, String fileName, HttpServletResponse response);
    /**
     * 删除文件管理表
     *
     * @param id
     * @return
     * @throws Exception
     */
    boolean deleteFile(Long id) throws Exception;

    /**
     * 文件管理表详情
     *
     * @param id
     * @return
     * @throws Exception
     */
    FileDetailVo getFileById(Long id) throws Exception;

    /**
     * 文件管理表分页列表
     *
     * @param fileRequest
     * @return
     * @throws Exception
     */
    Paging<FileResponse> getFileList(FileRequest fileRequest) throws Exception;


}
